home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / music / d10dump.lzh / english.doc < prev    next >
Text File  |  1989-04-05  |  12KB  |  268 lines
  1. Roland D10 Dump utility v1.0
  2. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3. Files
  4. ¯¯¯¯¯
  5. This archive should contain the following files.
  6. - DUMP1_0.PRG (Roland D10 Dump program v1.0)
  7. - ENGLISH.DOC (This document file)
  8. - README.1ST
  9. - 13 Sound-files (12 *.SND + DEFAULT.ALL)
  10.  
  11. Public Domain
  12. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  13. This program is public domain. This means that you can make as
  14. many copies of it as You see fit, and freely distribute these to
  15. friends, Bulletin Board Systems etc. Please note that You can't
  16. charge anything for the program(except a reasonable charge to
  17. cover distribution expenses). You're not allowed to alter the
  18. program or the accompanying document-file, and You must always
  19. distribute these files together.
  20.  
  21. Disclaimer
  22. ¯¯¯¯¯¯¯¯¯¯
  23. This program is supplied in the belief that it operates as specified,
  24. and the author shall not be liable in any circumstance whatsoever for 
  25. any direct or indirect loss or damage to property incurred or suffered
  26. by the person using this software, or any other person, as a result of using 
  27. this software.
  28.  
  29. Revision History
  30. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  31. This is version 1.0(as of 92/04/26).
  32.  
  33. Using the Program
  34. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  35. The program only runs in high resolution mode, but this will
  36. probably change when the next version hits the streets. I didn't
  37. have enough time to learn how to use resource-files in conjunction
  38. with GFA Basic, so I made my own graphical user interface, and
  39. this is screen-resolution dependent. Sorry! If You don't have
  40. access to a mono monitor You could always try one of the many
  41. mono emulators on the PD-market, but I'm not sure if this will
  42. work because the dumping of data from the D10 to disk is time
  43. critical, and most screen emulators have a tendency to devour 
  44. CPU time. Because of this there is a probability of losing data.
  45. There's no harm in trying, though, as the program will inform You
  46. about any loss of data. If the mono emulator is capable of
  47. setting the amount of CPU time that it uses, then please set this
  48. as low as possible.
  49.  
  50. The available menus(with options) are:  * Atari (Atari logotype)
  51.                                              - About DUMP1_0
  52.  
  53.                                         * Dump
  54.                                              - D10  to Disk
  55.                                              - Disk to D10
  56.                                              - Quit
  57.  
  58.                                         * Help
  59.                                              - Dumping
  60.                                              - Filetypes
  61.  
  62.  
  63.  
  64.  
  65. About DUMP1_0: Displays version number etc.
  66.  
  67.  
  68. D10 to Disk:    Initiates data transfer from D10 to disk.
  69.                 An alert box will pop up and ask for the
  70.                 filetype to be used. Next You will see a
  71.                 GEM fileselector where You can enter the
  72.                 name of Your dump-file to be, or abort by
  73.                 pressing the Cancel button. There's no need
  74.                 to give a file-suffix as this will be auto-
  75.                 matically appended by the program, and even
  76.                 if You do, the program still will be
  77.                 appending the correct suffix(according to
  78.                 chosen filetype). This is for Your con-
  79.                 venience, so that You'll be able to keep
  80.                 some kind of order among Your files.
  81.                 Having entered a filename and pressed OK,
  82.                 the transfer will start immediately. You
  83.                 won't need to push any buttons on the D10.
  84.                 The dumped data will then be saved under the
  85.                 filename You gave in the fileselector.
  86.                 This option can also be reached from the
  87.                 keyboard via ALT-S(Hold down Alternate
  88.                 key and press S). S as in Synthesizer or
  89.                 Save.
  90.  
  91.  
  92. Disk to D10:    The other way around! It operates the same
  93.                 way as D10 to Disk(above). When in the file-
  94.                 selector, just pick the desired file and
  95.                 press OK-button. This will dump data in
  96.                 file to the D10. Note that there's no check
  97.                 to see if the filename given has the same
  98.                 suffix as the filetype selected, but the
  99.                 fileselector will open up with *.filetype
  100.                 (e.g. *.SND if .SND is the selected file-
  101.                 type). This option can also be reached from
  102.                 the keyboard via ALT-D. D as in Disk or Dump.
  103.         (Clarification to the above): The program will
  104.         quite happily dump any MIDI Exclusive file
  105.         that You have around for Your D10. In order
  106.         for this to work You must first rename Your
  107.         file from *.XXX to *.SND(or *.RHY or *.ALL),
  108.         and then select the appropriate filetype to
  109.         the same suffix as You gave Your old file.
  110.         Example: You have a MIDI Excl. file for Your
  111.         D10 that contains the factory settings, and
  112.         this file is named DEFAULT.D10. Just rename it
  113.         to DEFAULT.SND, and when in DUMP1_0 select
  114.         Disk to D10 and .SND as the filetype.    
  115.  
  116.  
  117. Quit:           Quite self-explanatory! You will be able to
  118.                 take back if You made this choice by accident.
  119.                 This option can also be reached via ALT-Q.
  120.                 Q as in ... hmm? Quadragenarian maybe?
  121.  
  122.  
  123. Dumping:        This displays a brief helptext about the
  124.                 dumping procedure.
  125.  
  126.  
  127. Filetypes:      This displays a brief helptext about the
  128.                 filetypes used by the program, and their
  129.                 meaning.
  130.  
  131.  
  132. Filetypes
  133. ¯¯¯¯¯¯¯¯¯
  134. The filetypes(i.e. suffixes) used are: .SND, .RHY and .ALL.
  135. They indicate the kind of data to be processed.
  136.      .SND: Sound data only, i.e. Timbres, Patches and user
  137.            defined Tones(i01-64).
  138.  
  139.      .RHY: Rhythm data only, i.e. User Rhythm Patterns(P51-88),
  140.            Rhythm Track and Rhythm Setup.
  141.  
  142.      .ALL: Sound and Rhythm data as above plus Master Tuning,
  143.            Pan(Part 1-8), Reverb Type/Time/Level(Multi Timbral
  144.            mode), and Level(Part 1-8, Rhythm Part).
  145.  
  146. If in doubt, please consult Your Roland D10 manual, as this
  147. program transfers the same data as the Data Transfer function on
  148. the D10.
  149.  
  150. Other Roland D-series Synthesizers
  151. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  152. If I own a D20, can I use this program? Frankly, I don't know.
  153. This depends on a whole lot of things, the memory map of the D20 
  154. compared to that of the D10, The Model ID#(used in MIDI Exclusive
  155. messages, etc. The D20-owners maybe aren't that very interested in
  156. this program as they can save their sounds to disk via the built-in
  157. disk drive, but then there's always nice to be able to swap
  158. sounds with D10-owners. If You do decide to try this program with a
  159. D20, You should first check if the D20's Model ID# corresponds to
  160. that of the D10. If so, I think there is a fairly large chance that it
  161. will work due to the small differences between the models. The D10's
  162. Model ID# is 16HEX(=22 Decimal). As for the D110 I don't think that
  163. it will work, because I seem to remember reading something about different
  164. addresses compared to the D10. The D50 is definetely ruled out, and as
  165. for the D5, I really can't say. It would be easy to incorporate
  166. functions for these(except for the D50), but in order for me to
  167. do that I need information about address spaces etc. Maybe I will
  168. try to obtain this info before the next release, who knows?
  169.  
  170. Your own D10-dumps
  171. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  172. If you've made some great sounds, rhythm patterns etc. Yourself,
  173. why not dump them and upload to Your local BBS or the atari
  174. archive (terminator).
  175.  
  176. Bugs!?
  177. ¯¯¯¯¯¯
  178. I have tested, and used, this program for a while now and it
  179. seems to work just fine(they always do, don't they!). If You
  180. should discover a bug, or some other kind of annoying feature
  181. please let me know, and I will try to fix it. In this version
  182. there is one thing I'm not very content with. GEM alert-boxes
  183. that appear when a TOS-error is generated(e.g. when You're trying
  184. to save a file and the disk is write-protected). I spent a great
  185. deal of time trying to direct these errors to my own error
  186. handler(as suggested in the GFA